home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / alfv10.zip / !ALF.DOC next >
Text File  |  1992-03-29  |  21KB  |  517 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                ALF  v1.0
  11.                     Copyright (C) by Scott Fell,1992
  12.                    A Thunderstorm Software production
  13.  
  14.  
  15.  
  16.              Released into the Public domain March 29, 1992
  17.              
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.        -----------------------------------------------------------
  29.  
  30.                              DISCLAIMER
  31.  
  32.         >>  If you do not agree to this disclaimer, don't use this
  33.             product!
  34.  
  35.         >>  ALF is supplied AS-IS.  ALF carries no warranty,
  36.             expressed or implied.  The person using ALF takes whole
  37.             responsibility as to the quality and performance of this
  38.             product.  The author of this program assumes no
  39.             responsibility for anything.
  40.  
  41.  
  42.        -----------------------------------------------------------
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                             S  E  C  T  I  O  N  S
  51.                             ----------------------
  52.  
  53.  
  54.        <1>    Why?                        <11>   Contacting the Author
  55.        <2>    What does it do?            <12>   Anything ELSE?
  56.        <3>    Installation                <13>   Bugs
  57.        <4>    If you have a Problem...    <14>   Limits
  58.        <5>    Compatibility               <15>   ALF and DesQview
  59.        <6>    CD-ROM users                <-->   REFERENCE
  60.        <7>    Maintenence                 <1>    Headers
  61.        <8>    Just a note                 <2>    Step Explanation
  62.        <9>    How much does it cost?      <3>    Submissions
  63.        <10>   Anything else?              <4>    Possible Problems...
  64.  
  65.  
  66.                             ----------------------
  67.  
  68.  
  69. Why?
  70. ----
  71.  
  72. I had another program that made up headers for the file-lists, and I
  73. loved the concept, and loved how it worked and kept up-to-date, but
  74. they wanted a 10$ registration fee before it would actually run by
  75. itself, and that huge "UNREGISTERED" notice would disappear.  I didn't
  76. like it, so I stopped using it, and decided to write my own.  So here
  77. it is- my submission to the SpitFire world...  Enjoy!
  78.  
  79.  
  80. What does ALF do?
  81. -----------------
  82.  
  83. It's a down-and-dirty header-maker for your SpitFire file-lists.
  84. Down-and-dirty meaning it won't clean your monitor, wash your car, or
  85. water your lawn, but it does what it's supposed to do, without fooling
  86. around with any unnecessary options.
  87.  
  88.  
  89. Installation
  90. ------------
  91.  
  92.         Knowing that you'd rather get it running than look over
  93.     instructions for an hour, use the following steps to get going
  94.     ASAP.  However:  I HIGHLY suggest taking at least a quick
  95.     look-through of the rest of this DOC file.
  96.  
  97.                 >>>>>  DO NOT SKIP ANY STEPS!!!!  <<<<<
  98.  
  99.  
  100.  ***If you have CD-ROM areas, you need to read the CD-ROM section!!!***
  101.  
  102. 1) Put all the EXE files into your SpitFire home directory (Where your
  103.    SFFAREA.DAT file is located).
  104.  
  105. 2) Execute ALFBAK.EXE
  106.  
  107. 3) Execute SFF_BAK.BAT (This batch file will be created for you when
  108.    you execute ALFBAK.EXE).  Run this file at this point in time, and
  109.    do not run it again until you're POSITIVE that ALF will work with
  110.    your system.
  111.  
  112. 4) Execute ALF whenever you want to update the headers in your
  113.    file-lists.  (As an event, it will update your headers as often as
  114.    you like, and you won't have to worry about it)
  115.  
  116.  
  117. 5) Goto step 4
  118.  
  119. >>If you're interested in knowing exactly what these steps do, consult
  120.   the last part of this DOC file.  There are more specific
  121.   explanations there.
  122.  
  123.  
  124.  
  125. If you have a problem..
  126. -----------------------
  127.  
  128.  
  129. If your computer belched when you ran it, and your file-listings are
  130. messed up, run !ALF once more.  If the listings are still messed up,
  131. then run the program BAD!_ALF, and then execute UNDO_ALF (a batch file
  132. that is created by BAD!_ALF), and your file-lists will be returned to
  133. how they were prior to running ALF.  I don't anticipate problems, but
  134. someone somewhere is going to have one, and this is the easy way to
  135. get back to normal.  If you want to try to use !ALF again, after
  136. you've had a problem, you can start at step 4 and see if it works.  If
  137. it doesn't work this time, run UNDO_ALF once more.
  138.  
  139. NOTE:  CD-ROM users beware!  If your file-listings from the CD-ROM are
  140. not in the EXACT same format as v3.1 (or v3.2) then you will have your
  141. file-areas screwed up.
  142.  
  143.  
  144.  
  145. Compatibility
  146. -------------
  147.  
  148. ALF will work on SpitFire v3.1.  It will also work with v3.2, BUT, if
  149. you have the multiline option for file-descriptions active (for
  150. version 3.2), the file-counter will be wrong.  If you want to test it
  151. out, please be sure to let me know!.. With the ALFBAK and BAD!_ALF,
  152. even if it does mess up, you have a 2 minute fix-process before
  153. everything is back to normal.
  154.  
  155. NOTE:  If you've added extended descriptions to your file- like a
  156.        second line, such as this,
  157.  
  158. DATA1.GIF      62,464  08-13-91  Data of Star Trek: The Next
  159.                                  Generation as Sherlock Holmes
  160.                                  -Episode 34
  161.  
  162. NOTE <continued> everything will be correct except for the number of
  163.        files in the area.  ALF will tell you that you have more files
  164.        than you do, because it counts the number of lines that are
  165.        used, not the number of filenames.
  166.  
  167.  
  168. CD-ROM users:
  169. ------------
  170.  
  171. When executing any of the programs in this package, you need to be
  172. aware of just one command-line parameter.  It is the path to your
  173. CD-ROM display files.  In most cases, this file-path is C:\SF\DISPLAY,
  174. which is the default setting.  If your configuration is different, you
  175. need to enter the path to your display files.  Just enter it on the
  176. command-line without any special parameters.  Remember to NOT use the
  177. following backslash!  If you do, the program will exit with an error,
  178. and halt.  If no path is specified, the default directory is used
  179. (C:\SF\DISPLAY).
  180.  
  181. NOTE:  If the structure of your CD-ROM display files is different from
  182. that of SpitFire, you WILL run into problems.  As long as there is a
  183. comma in the 18th space of the line, all will be well in the world.
  184. If there is no comma in the 18th character, then that line will be
  185. omitted in the final product.  (ie- if none of the lines have commas
  186. in the 18th place, ALL of the listings will be erased).  If the comma
  187. is there, then all of your file-lists will be just fine.  If it is not
  188. there, you might end up with no files listed in that area.  So here's
  189. what you do- On the command-line, instead of specifying the ACTUAL
  190. directory where the display files are, specify a DIFFERENT directory
  191. (That actually exists) on your disk where NO CD-ROM display files are.
  192. ALF will then skip the processing of your CD-ROM areas.  The regular
  193. file-areas will continue to be updated, but ALF will now ignore your
  194. CD-ROM areas.
  195.  
  196. NOTE:  There is a utility on Buffalo Creek's BBS that will add commas
  197.        in the right places in your CD-ROM areas, assuming that they're
  198.        not exactly the same as SpitFire's format.
  199.  
  200.         It is conceivable that ALF will eventually grow to include the
  201.     different CD-ROM listing formats.  If you have a format that you
  202.     want supported, please include a sample of the file listings, and
  203.     send it off to the author.
  204.  
  205.  
  206.  
  207. Maintenance
  208. -----------
  209.  
  210.         Every once in a while (you should run this by YOURSELF), you
  211.    will probably want to execute the program ALFBAK.EXE, and then run
  212.    the batch file (SFF_BAK.BAT) that it creates.  When you do this,
  213.    the CURRENT SFFILES.BBS will be copied into backup files. This way,
  214.    you can be assured that the back-ups of your SFFILES.BBS files will
  215.    be kept current, and you won't have to mess with adding back in all
  216.    the files that you've added to your areas since you last ran
  217.    ALFBAK. (This does the same with CD-ROM file-area lists)
  218.  
  219.  
  220.  
  221. Just a note
  222. -----------
  223.  
  224. This version of ALF does NOT do anything about the file upload-paths.
  225. it will not update or create headers for the upload areas.  If your
  226. upload and download are the same area, then the SFFILES.BBS file will
  227. be updated.  If they are separate, the download section will be
  228. updated